home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / probe22.zip / PROBE.DOC < prev    next >
Text File  |  1990-01-17  |  14KB  |  322 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                            *.* Wildcard Software *.*
  24.  
  25.                                    Presents
  26.  
  27.                                      PROBE
  28.  
  29.                  Version 2.2
  30.  
  31.                             Written by Ron Blessing
  32.  
  33.          Copyright (C) 1989,1990 Ron Blessing, Elkhart, IN
  34.                               All rights reserved
  35.  
  36.  
  37.  
  38. CHANGES IN VERSION 2.2                                                  page 1
  39. ======================
  40.  
  41.   This version adds the ability to insert characters in the search string. By
  42. pressing the INSERT key you toggle between insert and overwrite mode. Also, the
  43. HOME and END keys will move from beginning to end of the search string.
  44.  
  45. CHANGES IN VERSION 2.0
  46. ======================
  47.  
  48.   After using this program on a network for a while, I decided to add a couple
  49. of features that come in handy in my work.  You can now search for files using
  50. a specific date pattern and the program displays the files attributes.  Also,
  51. there were a couple of problems that croped up, ZIP files with stored paths
  52. for one, that I have corrected.
  53.  
  54. CHANGES IN VERSION 1.4
  55. ======================
  56.  
  57.   This version corrects a disappearing cursor problem on some color systems.
  58.  
  59.  
  60.  
  61. INTRODUCTION                                                            page 2
  62. ============
  63.  
  64.   PROBE is a file locator program with some additional features added that I
  65. wanted and couldn't find in the programs I have seen.  The program will allow
  66. you to:
  67.  
  68. 1) Search compressed files. Both the new "ZIP" and "ARC" (OOPS can I say "ARC"?)
  69.    files.
  70.  
  71. 2) List the matching files in the order they were found on the drive or it
  72.    will list the file names in alphabetical order.
  73.  
  74. 3) Change to the drive and directory of a matching file.
  75.  
  76. 4) Execute a matching file.
  77.  
  78. 5) Run the program as a menu driven program or as a command driven program.
  79.  
  80. 6) Scroll up and down thru the list of matching files.
  81.  
  82. 7) Search using a specific date pattern.
  83.  
  84.   The program is really easy to use and shouldn't require much explanation, so
  85. I'll try to keep this explanation brief and to the point.  I hope you find
  86. PROBE useful and encourage you to register it for $10.00, if you do.  You'll
  87. find a pre-printed form at the end of this documentation for easy registration.
  88.  
  89. PCONFIG.EXE
  90. ===========
  91.  
  92.   If you are going to run PROBE on a color system, run this program first.
  93. PCONFIG will allow you to select the foreground and background colors that the
  94. program uses.  If you wish to use BIOS calls for screen writes, to prevent
  95. "snow" on a CGA monitor, you can select this option too.  The selections can be
  96. toggled by pressing the space bar.  The color selections will clear the screen
  97. and redraw it in the new colors as they are toggled, so you can see what you're
  98. selecting.  When you are happy with the selections, press "F1" and a file
  99. named "PROBE.CFG" will be created containing all the configuration
  100. information.  This file needs to be kept in the same directory as the PROBE
  101. main program so that the program can find it when it starts up each time.  If
  102. this file can't be found during start-up, the program will default to NOT CGA,
  103. gray letters and black background.
  104.  
  105.  
  106. COMMAND DRIVEN OPERATION                                                page 3
  107. ========================
  108.  
  109.   You can run PROBE two different ways.  The quickest way is by including the
  110. path, pattern to search for and any "switches" on the same line that commands
  111. DOS to run PROBE.  The format is the following:
  112.  
  113.                      C> PROBE <path> <pattern> <switches>
  114.  
  115. Both the path and pattern is optional and switches are optional.  Path will
  116. default to the current directory if not included and pattern will default
  117. to "*.*" if path is included without a pattern.  You have a choice of the
  118. following switches:
  119.  
  120.           SWITCH                RESULT
  121.           ======     =======================================================
  122.             /a       Sort matching files alphabetically by file name.
  123.  
  124.             /p       Search compressed files. (".ZIP" or ".ARC" extension)
  125.  
  126.             /r       Run the first matching file from current directory.
  127.                      (File must be "EXE" or "COM" or "BAT" file.)
  128.  
  129.             /g       Change to first matching files directory and run it.
  130.                      (File must be "EXE" or "COM" or "BAT" file.)
  131.  
  132.             /c       Change to first matching files directory.
  133.  
  134.         /dXXXXXX Search for files matching "XXXXXX" date.
  135.              (EX: /d100089 means search for files with Oct of 89 date)
  136.  
  137.  So, if you wanted to search for files on drive "A:" with the string "DOC" in
  138. them, have the files displayed alphabetically and search compressed files, you
  139. would enter the following string:
  140.  
  141.                           probe a:doc /a /p
  142.  
  143. MENU DRIVEN OPERATION
  144. =====================
  145.  
  146.   The second way to run PROBE is by just entering "probe" at the DOS prompt and
  147. pressing "Enter".  The program will present you first with an opening screen,
  148. asking you to register the program, and after pressing a key, you will see the
  149. search parameters menu.  Enter the drive, path and pattern you want the program
  150. to search for and then, using the arrow keys to change fields and the space bar
  151. to toggle selections ON or OFF, select the options of searching compressed
  152. files and/or displaying the matching files in alphabetical order.  The program
  153. defaults to the current drive, root directory and "*.*", if the path or pattern
  154. are left blank.  When you have everything set up, press the F1 function key to
  155. start the search.
  156.  
  157. FILE DISPLAY
  158. ============
  159.  
  160.   If any matching files are found, the program will display first the path to
  161. those files on one line and then the filename, creation date, creation time,
  162. file size and attributes on the next line.  If there are more files found than
  163. will fit on one screen, you can use the up/down arrow keys, page up/down keys,
  164. "Home" key and "End" key to scroll thru the files.  You will notice the
  165. "[N]ext", "[C]hange", "[G]o" and "[R]un" options on the bottom line of the
  166. display.  "[G]o" and "[R]un" will only show up if the highlighted bar is on an
  167. "EXE", "COM" or "BAT" file.  With these options and by moving the highlighted
  168. bar, with the arrow keys, you can:
  169.  
  170.  
  171.                                                                         page 4
  172.        SELECTION                      RESULT
  173.        =========   ========================================================
  174.        [N]ext      Return to the search parameters menu for another search.
  175.  
  176.        [C]hange    Change to the drive and directory of the highlighted file.
  177.  
  178.        [G]o        Change to the drive and directory of the highlighted file
  179.                    and run it. (File must be "EXE" or "COM" or "BAT" file.)
  180.  
  181.        [R]un       Run the highlighted file from the current directory.
  182.                    (File must be "EXE" or "COM" or "BAT" file.)
  183.  
  184.  
  185.  Note:
  186. ======
  187.   Not all files will execute correctly if run from this program but I've
  188.   found the major portion of them will.  Watch for improvements to this
  189.   function.
  190.  
  191.  
  192. SEARCH PATTERNS
  193. ===============
  194.  
  195.   The program recognizes the standard DOS wildcards but it does the matching a
  196. little differently.  If you enter a string, any filename containing that string
  197. will match it, "*" matches everything up to a period and "?" matches any single
  198. character.  For example:
  199.  
  200.            INPUT                      MATCHES
  201.           =======      =====================================================
  202.             dog        Any file name containing "dog".
  203.  
  204.             dog.       Any file named "dog".
  205.  
  206.             dog*       Any file name that starts with "dog".
  207.  
  208.             dog*.      Any file name that starts with "dog" and has no
  209.                        extension.
  210.  
  211.             dog*.*     Any file name that starts with "dog".
  212.  
  213.             dog*.?     Any file name that starts with "dog" and has a one
  214.                        letter extension.
  215.  
  216.             ???        Any three letter file name.
  217.  
  218.  
  219.  
  220.  
  221. SEARCH DATE                                                             page 5
  222. ===========
  223.   After using PROBE on a network for a while, I decided that this feature would
  224. come in real handy.  There are a lot of times when you want to know what files
  225. have been created of modified on a certain date.  By entering a search date,
  226. the program will only display the files that match the name search pattern and
  227. that match the search date.  If you only want to specify a year to match, just
  228. set the month and day to "00" or if you want a month and a year set the day to
  229. "00" etc.
  230.  
  231.  
  232. USER SUPPORTED SOFTWARE
  233. =======================
  234.  
  235.   This program is copyrighted material written for private use.  It was not
  236. intended specifically for commercial use.  You may freely distribute this
  237. software as long as:
  238.  
  239.   1) No fee is charged for such distribution, other than the cost of
  240.      duplication and mailing.
  241.   2) The entire package is distributed as a whole without modification of any
  242.      kind.
  243.  
  244.   No claims are made as to the program's suitability for any specific purpose.
  245. The author disavows responsibility for any damages resulting from the use of
  246. this program.
  247.  
  248.   If, after a reasonable evaluation period, you find this program useful,
  249. please send a check or money order for $10.00 to the address below.  If you
  250. don't wish to use the program, please pass it on to someone who may want to use
  251. it.
  252.  
  253.  
  254.  
  255.  
  256. COMMERCIAL                                                              page 6
  257. ==========
  258.  
  259.    If you like PROBE, you might also like our program FONEBOOK.  FONEBOOK
  260. turns your computer into a personal telephone directory that even dials for
  261. you!
  262.    If you're like most people, you probably have names, addresses and phone
  263. numbers scribbled on little bits and pieces of paper all over the place.
  264. FONEBOOK is a tool to help you organize all those bits and pieces into a single
  265. database of names, addresses, phone numbers and comments.
  266.    With FONEBOOK you can add and change names, addresses and phone numbers;
  267. browse or search through the database on any field; and quickly find and
  268. dial (with modem) any phone number.
  269.    You can also print out everything or only selected records, showing just
  270. phone numbers, just addresses or all fields to a printer or to disk as an
  271. ASCII file.
  272.  
  273.  
  274.   Then there's our program DISK_TAG.  DISK_TAG allows you to print a custom
  275. directory listing that will tuck nicely inside the disk sleeve and if you need
  276. the sleeve, it will print out a custom sleeve for your disk.  You can choose to
  277. print out just the root directory or the contents of all directories, and
  278. choose to print out the contents of archived files found on the disk or just
  279. the archived file name.  The listings and sleeves contain space for a comment
  280. line and a disk number.  The program creates sleeves and directory listings for
  281. both the 5 1/4" and 3 1/2" disks.  The sleeves will fit in standard disk
  282. holders.
  283.  
  284.  
  285.  
  286. ==============================================================================
  287. [                           REGISTRATION FORM                                ]
  288. [                           PROBE Version 2.2                                ]
  289. [                                                                            ]
  290. [   Date: ____/____/____                        TO: Wildcard Software        ]
  291. [                                                   28480 C.R. 4 West        ]
  292. [                                                   Elkhart, IN   46514      ]
  293. [                                                                            ]
  294. [  FROM:                                                                     ]
  295. [        Name: __________________________________________________            ]
  296. [                                                                            ]
  297. [     Address: __________________________________________________            ]
  298. [                                                                            ]
  299. [        City: __________________________ State: ___ Zip: _______            ]
  300. [                                                                            ]
  301. [     Area Code (______) Phone: _________________________________            ]
  302. [                                                                            ]
  303. [   Comments:  __________________________________________________            ]
  304. [                                                                            ]
  305. [              __________________________________________________            ]
  306. [                                                                            ]
  307. [              __________________________________________________            ]
  308. [                                                                            ]
  309. [                                                                            ]
  310. [      ___ Enclosed is $10.00 for a single registration of PROBE.            ]
  311. [                                                                            ]
  312. [      ___ Enclosed is $15.00 please mail me a registered copy of FONEBOOK.  ]
  313. [                                                                            ]
  314. [      ___ Enclosed is $15.00 please mail me a registered copy of DISK_TAG.  ]
  315. [                                                                            ]
  316. [                                                                            ]
  317. ==============================================================================
  318.  
  319.  
  320.  
  321.  
  322.